Windows capturing

A Windows 'printer capture' also records the current printer name
However, the default "restore" only restores the various settings and 
leaves the currently selected printer name untouched. By using "restore_all" 
one can also force the printer name to be restored at the same time.

There are two available 'captures': one for the plug-in startup and 
a 'current' capture.

When the plug-in launches, the current default print setup is saved 
internally (this is called the startup state). The startup state is 
never modified - it can only be read from, not written to.

This startup state is accessed by calling the following functions:

  PrSw_GetStartupPrinter (returns a numerical index in the list of printer names)
  PrSw_PrintSetup("capture_startup") (returns a long string which encodes all printer info)

There is also a 'current state' which can be consulted at all times
(not just after a call to PrintSetup[]). Initially, this current state
will be the same as the startup state, but it can easily be modified
using the various PrSw calls.

Calls that affect the current state:

  PrSw_SelectPrinter(printerNumber)
  PrSw_PrintSetup("restore|....")
  PrSw_PrintSetup("restore_all|....")
  PrSw_PrintSetup("restore_startup")

The difference between "restore|..." and "restore_all|..." is that "restore_all" also 
restores the selected printer. "restore|..." on the other hand will not affect the
settings defined through PrSw_SelectPrinter.
"restore_all...|" is like a combined PrSw_SelectPrinter and PrSw_PrintSetup("restore|....").

PrSw_PrintSetup("restore_all|...") with the data returned from PrSw_PrintSetup("capture_startup")
is equivalent to calling PrSw_PrintSetup("restore_startup")

Calls that capture the current state:

  PrSw_CurrentPrinter
  PrSw_PrintSetup("capture")
  
PrSw_PrintSetup("capture") captures the current printer state, INCLUDING
the name of the current printer. This is typically called after a call
to PrintSetup([]), but can be called at any point in time. 

Typical use:

- Call PrSw_PrintSetup("capture_startup") if you want a 'fixed reference point'
The returned data will not change: it always refers back to the printer status
at the moment FileMaker (or the plug-in) was launched.

- Call PrSw_PrintSetup("capture") on launch a new FileMaker document - this
will grab the 'current state' at the moment of launch.

- You can call PrSw_PrintSetup("restore_all|....") with this captured startup
data to restore the original state when the FileMaker document closes.

- You can also call PrSw_PrintSetup("restore_startup") to restore the printer
state to what was set when FileMaker (as opposed to the FileMaker _document_) 
launched. 

- The currently selected printer is saved to the preferences when you call
PrSw_Configure("save") - this particular printer will be re-selected by
default on the next PrSw extension reload.

